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Batocera scripts 


You can opt to have scripts launched at various points in Batocera. This will change the location you 
save the script to and how it opens. 


Scripts during boot/shutdown 


When booting and shutting down, Batocera checks for scripts three times at different stages in the 
boot/shutdown process: 


e /boot/boot-custom.sh, a special case if you need scripts executed very early in the boot process 

e /boot/postshare.sh, to launch scripts right after userdata is mounted 

e /userdata/system/custom.sh, after EmulationStation has loaded, the preferred method for most 
use-cases 


When these scripts are executed, Batocera sends the first argument to the script as start when 
Batocera is booting and stop when Batocera is shutting down. Putting code into cases or other 
checks for these argument values will cause that code to only be executed when booting or shutting 
down, otherwise code will be executed on both boot and shutdown. 


boot-custom: First during startup, last after shutdown 


In Batocera v32 and higher, scripts can be launched early in the boot process, before much of 
Batocera has even begun loading. This is done by storing the script in the boot partition at 
/boot/boot -custom.sh. Keep in mind that this script will be limited to more basic 
commands/modules, as most things have not loaded yet. The filename must be boot- custom. sh 
otherwise it will not be checked. 


Precisely, this is the first thing executed once init.d has begun. This is before the 

ey network/share population/IR remote daemon have even loaded so capabilities are 
limited. Check /etc/init.d to see the exact order of all the modules have been loaded 
in (SOO@bootcustom is when the /boot/boot- custom. sh is executed). 


This can be used to effectively patch and/or override the modules loaded by Batocera. Here are some 
examples that are only possible with this method: 


e Customize or disable S33disablealt fn to allow a certain text mode console on a particular 
TTY session. 
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e Tinker with hwclock to save local time instead of universal time to RTC. 
e Run fsck -aore2fsck -p to harden the file system against data corruption in the case of a 
power cut/disconnection. 


postshare: First after mounting userdata mount, last before userdata gets 
unmounted 


In Batocera v35 and higher, scripts can also be launched after /userdata is mounted in the boot 
process, before the splash video plays (and before Emulationstation has begun loading). It has to be 
placed to /boot/postshare. sh and is executed directly by the bash interpreter (no executable flag 
required). 


custom: Last during startup, first after shutdown 


Sometimes you just want to fire up one script after successfully booting, for example when you want 
to start up a VPN or other after-boot tasks. In order to do this, create a script text file at 
/userdata/system/custom. sh. Be aware that the script will be executed independently of the 
executable (x) attribute being set to the script file or not! 


This script is the very last one that will be invoked by Batocera at boot time after EmulationStation 
has launched (check /etc/init.d/ to see all the modules that are loaded before then, 
S99userservices (previously S99custom in Batocera v38 and below) is when the user script is 
launched). The filename must be custom. sh otherwise it will not be checked. 


A simple custom script as an example 


custom.sh 


#!/bin/bash 
# Code here will be executed on every boot and shutdown. 
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# Check if security is enabled and store that setting to a variable. 
securityenabled="$(/usr/bin/batocera-settings-get 
system.security.enabled) " 


case "$1" in 
start) 


# Code in here will only be executed on boot. 
enabled="$(/usr/bin/batocera-settings-get 


system.samba.enabled) " 


if [ "$enabled" = "0" ]; then 
echo "SMB services: disabled" 
exit 0 
fi 
stop) 


# Code in here will only be executed on shutdown. 
echo -n "Shutting down SMB services: " 

kill -9 `pidof smbd. 

RETVAL=$? 

rm -f /var/run/samba/smbd.pid 

echo "done" 


=. 
rF 


restart | reload) 


y 


# Code in here will executed (when?). 
echo "SMB services: reloaded" 


m7 


# Code in here will be executed in all other conditions. 
echo "Usage: $0 {start|stop|restart}" 


1 


Watch for a game start/stop event 


Batocera 5.23 and higher supports running a script right before a game launches and/or after a game 
is exited. Here are some examples: 


e Automatic controller setup 

e Automatic scraping for new games 

e Change screen resolution (though it might be better to use switchres for this) 
e Sync savestates to an external/network device 

e ... give me your idea here 


Place an executable script (can have any filename) with the correct setted shebang (first line!) or an 
executable binary into directory /userdata/system/scripts/. 
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# Open up a text editor to create your script: 
nano /userdata/system/scripts/first script.sh 


# Write in your script, save and exit. 
# Then to add the executable bit to it: 
chmod +x /userdata/system/scripts/first script.sh 


You can add as many subfolders as you want, every script placed there will be executed. To 
distinguish between START or STOP condition the first argument parsed in the script have either of 
these flags: 


e gameStart is passed to your scripts if you select a game from EmulationStation (Game Starts!) 
e gameStop is passed to your scripts if you are going back from a game to EmulationStation 
(Game Stops!) 
If you do not set cases for first argument, then the script is executed on every start and 
on every end of a game. 


What is parsed 


Table of parsed arguments in correct order and their functions: 


1 |gameSta rt or gameStop To distinguish between START or STOP condition 


The system shortname as is in es system.cfg, eg. 


3 |system. config[ 'emulator' ]|The emulator settings, eg. libretro 
| 4 |system. config['core' ] The emulator core you have chosen, eg. stella 


The full rom path, eg. 
5 Jargs. rom /userdata/roms/atari2600/Mysterious Thief, A 
(USA).zip 


Simple game start/stop script as an example 


At first create the directory where the scripts need to be set up. Connect through SSH and type 
mkdir /userdata/system/scripts. After this we can set up our first script by typing nano 
/userdata/system/scripts/first script.sh. The filename can be anything readable by 
bash. 


Here's the template script: 
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first_script.sh 


#!/bin/bash 
# This is an example file of how gameStart and gameStop events can be 
used. 


# It's good practice to set all constants before anything else. 
logfile=/tmp/scriptlog.txt 


# Case selection for first parameter parsed, our event. 
case $1 in 
gameStart) 
# Commands in here will be executed on the start of any game. 
echo "START" > $logfile 
echo "$@" >> $logfile 
gameStop) 
# Commands here will be executed on the stop of every game. 
echo "END" -- $logfile 


esac 


Now you can see a log file created /tmp/scriptlog.txt, that parsed all arguments in this file. This 
is just a small test of course. You can check out the SSH page and the usage of batocera-settings 
page for general and Batocera-specific commands. 


EmulationStation scripting 


In case Batocera's provided scripting functionality is not sufficient, ES itself also triggers scripts of its 
own volition. Extra scripts can be created at 
/userdata/system/configs/emulationstation/scripts/<event name>/<script>.sh; 
unlike regular Batocera scripts the event named will trigger all scripts in the respective event folder. 
For instance, to have a script execute at every game-start event, it must be placed in 
/userdata/system/configs/emulationstation/scripts/game-start/. 


# Open up a text editor to create your script: 
nano /userdata/system/configs/emulationstation/scripts/game- 


start/first script.sh 

# Write in your script, save and exit. 

# Then to add the executable bit to it: 

chmod +x /userdata/system/configs/emulationstation/scripts/game- 
start/first script.sh 
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Eventname  | 
When a game starts. 
Nearly identical to 
Batocera's 

game -start ROM name rom, ROM path basename (arguments gameStart, however 

described below) this doesn't include as 

much information and 
only triggers when it's 
ES itself that starts it. 
When a game ends. 
Nearly identical to 

game -end Batocera's gameStop, 
however this only 
triggers when it's ES 
itself that ends it. 
New to Batocera v33. 
Whichever game is 

game-selected getSourceFileData()-getSystem()-getName(), bel oe 

de than) de Meel) Includes games shown 

during the 
screensaver. 


New to Batocera v33. 

Whichever system is 
system-selected |System getSelected()-getName( ) currently being 

hovered over in the 


When a different 
Theme being switched to theme is selected. 
theme - changed theme set-getSelected(), Previous theme Mostly used for 
oldTheme 


sad a System 


EE a le 
mapping is saved 
controls-changed N/A from the 
CONTROLLER 
MAPPING menu. 


Whenever any 
configuration, be it 
system settings or 
controller mappings, 
is changed. 


When the system is 
told to do a regular 


config - changed 


shutdown. 
When the system is 
told to do a reboot. 
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When the system is 
shutdown N/A told to do a fast 

shutdown. 

When the system is 


When the system is 
wake N/A told to wake from 
: : : RetroAchievement is 
achievements with arguments described below Unlocked anew ES 
Batocera v38 


EmulationStation sends different arguments to these scripts based on the event type. For game- 
related events: 


Parsed parameter 
system |The current system of the game. 


om 
romname || |The name of the game as specified in its metadata. 


tD All events need to be added here. 


Simple EmulationStation script example 


This script is an example of an EmulationStation game- selected script for controlling the Pixelcade 
display. More robust results with the Pixelcade may be achieved with the Pixelcade Batocera scripts. 


pixelcade.sh 
#!/bin/bash 


# Save the arguments into variables. 
system="${1}" 

rom="${2}" 

romname="${3}" 


# Convert an argument into another value. 

if [[ "${system}" == "fbneo" ]]; then 
system="mame" 

fi 


# Switch case for certain systems. 
case ${system} in 
fbneo) 
system="mame" 
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Fi 

scummvm ) 
rom="${rom%. *}" 
Fi 


esac 


# Execute this part every time this event triggers. 

curl -G \ 
--data-urlencode "t=${romname}" \ 
http://127.0.0.1:8080/arcade/stream/${system}/ basename ${rom}- 


Real use cases 


Batocera after boot scripts 
e Shutdown Batocera at a given time 


custom.sh 


#!/bin/bash 
while true; do 
currenthour=$(date +%k%M) 
if [ $currenthour -eq 2355 ]; then 
shutdown -h now 
ie 
sleep 30 
done 


e Disable a specific network interface (e.g. eth0, eth1, etc.) 


custom.sh 


#!/bin/bash 
ifconfig ethl down 


Batocera event watcher scripts 


e Output text to a file 
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outputsomething.sh 


#!/b 
# by 


test 
echo 
echo 
echo 
echo 
echo 
Eis: 
"No 


in/bash 
cyperghost for batocera 


file="/userdata/system/scripts/output. txt" 

"END Script!" >> $testfile 

"Parameter: $@" >> $testfile 

"Systemname: $1" >> $testfile 

"Emulatorcore: $2" >> $testfile 

"ROM: $(basename "$3")" >> $testfile 
$4" == "Libretro" ]] && echo "You are free!" >> $testfile || echo 
hotkey is pure hell eh??" >> $testfile 


e Change LED colors while running games, and shutdown on button press 


shutdownsimple.sh 


#!/bin/bash 
LED1—22 
LED2=27 
SHUTDOWN=3 
case "$1" in 
start) 

# LED init 


hed 


echo "$LED1" > /sys/class/gpio/export 

echo "$LED2" > /sys/class/gpio/export 

echo out > /sys/class/gpio/gpio$LED1/direction 
echo 0 > /sys/class/gpio/gpio$LED1/value 

echo out > /sys/class/gpio/gpio$LED2/direction 
echo 1 > /sys/class/gpio/gpio$LED2/value 


#Button init 

echo "$SHUTDOWN" > /sys/class/gpio/export 

echo "in" > /sys/class/gpio/gpio$SHUTDOWN/direction 

#This loop continuously checks if the shutdown button was pressed 

#It sleeps as long as that has not happened. 

buttonstatel=$(cat /sys/class/gpio/gpio$SHUTDOWN/ value) 

shutdownSignal=$(cat /sys/class/gpio/gpio$SHUTDOWN/ value) 

while [| $shutdownSignal = $buttonstatel ]; do 
shutdownSignal=$(cat /sys/class/gpio/gpio$SHUTDOWN/va Lue) 
sleep 0.5 

done 

shutdown -h now 


stop) 


Batocera.linux - 


#unexport all GPIOs 
#echo "$SHUTDOWN" > /sys/class/gpio/unexport 
echo "$LED1" > /sys/class/gpio/unexport 
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echo "$LED2" > /sys/class/gpio/unexport 
esac 
exit $? 


e Load latest created savestate automatically 


loadlatestsave.sh 


#!/bin/bash 


# disable auto load/save state inside ES 

# add ‘global.retroarch.savestate auto load=true' 

# to your batocera. conf 

# by cyperghost aka lala for BATOCERA 

# 

# download this script to '/userdata/system/scripts' and set executable 
bit 

# 


rom_no_ext="$(basename "${5%.*}")" 
sav_path="/userdata/saves/$2" 


[[ "$(batocera-settings get global.autosave)" -eq 1 ]] && exit 
[[ "$(batocera-settings get global.retroarch.savestate_auto_load)" == 
"true" ]] || exit 


if [[ $1 == "gameStart" ]]; then 
file="$(/bin/ls "$sav_path/$rom_no_ext."* -turR1A | tail -1)" 
Mn sne jy (ese 
[[ "${file##*.}" == "png" |] && file="${file%. *}" 
[[ -f "$file" ]] || exit 
cp -f "$file" "$sav_path/$rom_no_ext.state.auto" 


fi 
if [[ $1 == "gameStop" 1]; then 

rm -f "$sav_path/$rom_no_ext.state.auto" 
ita 


e Faff about with audio settings. 


audio-shenanigans.sh 
case "$1" in 


start) 
# Get the current audio profile. 
defaultprofile="$(batocera-audio get-profile) " 
# Get the current audio device. 
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defaultaudio="$(batocera-audio get)" 

# Set the audio device to HDMI-2. 
batocera-audio set HDMI-2 

# Set the default "auto" audio profile. 
batocera-audio set-profile auto 


# Unmute the audio device. 
batocera-audio setSystemVolume unmute 
# Set audio level to 69. 
batocera-audio setSystemVolume 69 
# Test the audio device with Mallet.wav 
batocera-audio test 
stop) 
# Toggle the audio mute. 
batocera-audio setSystemVolume mute-toggle 


Batocera boot scripts 


Delay Syncthing until after everything else 


boot-custom.sh 


#!/bin/bash 
# Delay Syncthing until other boot stuff has completed. 


if [[ "$1" != "start" ]] && exit 0; then 
if mv /etc/init.d/S27syncthing /etc/init.d/S99syncthing; then 
echo "Successfully delayed Syncthing." 
elif ls /etc/init.d/S99syncthing; then 
echo "Command has already run!" 
exit 0 
else 
echo "Syncthing failed to be delayed." 
touch /userdata/check-boot-custom-sh 
shutdown -h now 
exit 1 
fi 
ial 


exit $? 


EmulationStation scripts 
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Play a video on a second screen 


Original forum post with a deeper explanation. Artwork needs to be sourced and placed in the 
appropriate Marquee and roms/Marquee folders first. 


Place game. sh into system/configs/emulationstation/scripts/game-selected 


game.sh 


#!/bin/bash 

System=$1 #system name 

Romname=${2%.*} #romname 

rom=${Romname##* / } 

/userdata/marquee.sh Gameselected $System "$rom" 


Place system. sh into system/configs/emulationstation/scripts/system-selected 


system.sh 


#!/bin/bash 
System=$1 #System name 
/userdata/marquee.sh Systemselected $System & 


Place marquee.shin /userdata 


marquee.sh 


#!/bin/bash 


case $1 in 

Start) 

Romname=$3 

Gamepath=$2 

marqueeimage=$Gamepath/images/$romname-marquee.png 

if [ -f "/userdata/roms/Marquee/videos/$Romname.mp4" | 

then 

ffmpeg -i /userdata/roms/Marquee/videos/$Romname.mp4 -vf scale=1280:720 
-sws flags bilinear -pix fmt rgb565le -f fbdev /dev/fb0 


ha 


if [ -f "/userdata/roms/Marquee/hires/$Romname. jpg" | 


then 

fbv /userdata/roms/Marquee/hires/$Romname.jpg -fer 
elif [ -f "$marqueeimage" | 

then 

fbv $marqueeimage -fer 

else 
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fbv /userdata/roms/mame/images/mame.png -fer 
fi 


Gameselected) 
System=$2 #system name 
Romname=$3 #romname 


if [ -f "/userdata/roms/Marquee/$Romname.png" | 

then 

fbv /userdata/roms/Marquee/$Romname.png -fer 

elif [ -f "/userdata/roms/$System/images/$Romname-marquee.png" | 
then 

fbv "/userdata/roms/$System/images/$Romname-marquee.png" -fer 
else 

fbv /userdata/roms/Marquee/mame.png -fer 

fi 


"on 
N) 


Systemselected) 
imagepath="/userdata/roms/sysimages/$2" 

if [ -f "$imagepath.png" | 

then 

fbv "$imagepath.png" -fer 

else 

fbv /userdata/roms/mame/images/mame.png -fer 
fi 


esac 


Place script.shin system/scripts 


script.sh 
#!/bin/bash 


case $1 in 
gameStart ) 


gamepath=$ {5%/*} 
romname=$ {5##*/} 
/userdata/marquee.sh Start $gamepath ${romname%.*} & 


yy 


gameStop) 
killall ffmpeg 


EF 
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esac 


From: 
https://wiki.batocera.org/ - Batocera.linux - Wiki 


Permanent link: 
https://wiki.batocera.org/launch_a_script 


Last update: 2024/02/27 17:18 


https://wiki.batocera.org/ Printed on 2024/04/08 17:31 


